…LMO-4030

…e-retrieve-LLMO-4030

Made-with: Cursor

# Conflicts:
#	src/controllers/llmo/llmo-brand-presence.js
#	src/controllers/llmo/llmo-mysticat-controller.js

Made-with: Cursor

…O-4030

Add urlId field to domain-urls handler response mapping so the UI can
pass it to the url-prompts endpoint for Phase 3 drilldown.

Made-with: Cursor

… LLMO-4030

Replace broken parseBody(response) helper with standard response.json()
to match the Web Response API used by spacecat-shared-http-utils. Add
comprehensive tests for all error paths (model validation, RPC errors,
missing params, site-org validation) and null-field handling to reach
100% line/branch/statement/function coverage.

Made-with: Cursor

Summary-table RPCs no longer accept p_brand_id (brand_id is not in
the summary table). Update handlers and tests accordingly.

Made-with: Cursor

Add test for trending URL rows with valid url but null content_type,
prompt, category, region, topics, citation_count, execution_count,
and total_non_owned_urls to reach 100% branch coverage.

Made-with: Cursor

Document the 6 URL Inspector API endpoints under the org-scoped
brand-presence path:
- stats: aggregate citation stats + weekly sparklines
- owned-urls: paginated owned URL citations with WoW trends
- trending-urls: paginated non-owned URLs grouped by URL
- cited-domains: domain-level citation aggregations
- domain-urls: Phase 2 drilldown into domain URLs
- url-prompts: Phase 3 drilldown into prompts per URL

Adds response schemas and path references. Validated with docs:lint
and docs:build.

Made-with: Cursor

…e-retrieve-LLMO-4030

Resolve merge conflict in docs/index.html by regenerating from
merged OpenAPI sources.

Made-with: Cursor

Addresses review feedback asking for brandalf-style .md docs for the new
URL Inspector endpoints so AI / on-call engineers have a reliable reference.

Adds one doc per endpoint (stats, owned-urls, trending-urls, cited-domains,
domain-urls, url-prompts) plus a consolidated url-inspector-apis-overview.md,
and links the new overview from brand-presence-apis-overview.md. Each doc
covers path shape, query params (incl. aliases and defaults), RPC signature
with conceptual SQL, response shape, sample URLs, error responses, and
auth/access expectations.

Made-with: Cursor

…dler - LLMO-4030

The stats handler's try/catch around Promise.all and the
code/details/hint string-building in the RPC-error log were uncovered,
dropping coverage below the 100% global threshold. Add four focused
tests: one for message-only PostgREST errors (exercises the falsy
branches of the code/details/hint ternaries), one with all three
populated (truthy branches), one for a rejected Promise with an Error
instance, and one for a bare-string rejection (exercises the
`e?.message || e` fallback).

Made-with: Cursor

Resolve docs/index.html conflict by regenerating via npm run docs:build
against the merged docs/openapi/ sources (auto-merged cleanly). All
other files auto-merged without conflicts.

Made-with: Cursor

The pinned v1.56.0 tag has been evicted from ECR (ECR lifecycle
retention), causing ci/it-postgres to fail on both main and this branch
with "manifest unknown". Bump to v1.67.8 (released 2026-04-21, latest
available image) to restore integration tests.

This is a fix for a pre-existing main-branch issue that surfaced on
this PR after the last merge; landing it here unblocks both branches.

LLMO-4030

Made-with: Cursor